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Introduction to Connexions 
An overview of Connexions, the Connexions home page, navigation tools, 
and accounts. 


Note:This module contains Connexions documentation which is out-of- 
date. The contents of this module are provided here for historical purposes 
only and should not be considered accurate for the current version of the 
Connexions website. The current documentation of topics in this module 
can be located at http://cnx.org/content/m10884/latest/. Please visit the 
help page for up-to-date information about the Connexions website, 
including support for viewing and authoring content and the CNXML 
language. If you have any additional questions or cannot find the answer to 
your question, please contact techsupport@cnx.org and we will be happy 
to assist In any way we can. 


Overview 


Connexions is a web-based document creation and management system for 
education and research materials. There are two parts to Connexions: a 
Content Commons that contains these materials and the software tools 
necessary to create, manage, and access these materials. A tour of the 
workings of Connexions and its parts appears on the Connexions web page, 
under the "About" tab. 


From its inception, Connexions was designed to allow the collaborative 
development and free availability of material. Instructors and authors can 
modify this material for any educational purpose. Connexions offers 
Free/Open Source software tools to help students, instructors, and authors 
manage these information assets for sharing and advancing knowledge to 
benefit the global educational community. All of this is accomplished 
through the use of the Creative Commons Attribution license. 


There are three general categories of Connexions users: 


e Students - who use Connexions to access information on-line, to 
prepare for their classes. 

e Authors - who enter content into Connexions in document files called 
modules. 

e Instructors - who build courses, which are documents created by 
linking related modules together in a specific order. 
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Before you begin using the Connexions system, you should verify that you 
have all of the necessary software. Visit the Connexions Quick Start Guide 


for a listing of the software that you will need and the links to help you 
download it. 


The Connexions Home Page 


The Connexions home page is the starting point for your use of 
Connexions. It contains the following items: 


e Breadcrumb Navigation Bar 
e Search 

e Quick Start 

e Courses 

e Personal toolbar 

e Navigation Sidebar 
e Login Sidebar 

e Spotlight Sidebar 

e e-Mailbag Sidebar 
e What's New Sidebar 
e Workspaces Sidebar 


These items also appear on the other Connexions web pages. 
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Home, About, Content, Software, and Help Tabs 


On the upper left of the Connexions home page are tabs labeled "Home", 
"About", "Content", "Software", and "Help". Clicking on these tabs display 
the following Connexions pages: 


e Home returns to the Connexions home page. 
e About displays the "About" page that contains a general description of 
Connexions and links to more detailed information about Connexions, 


how it works, the people behind it, and a list of contacts. 

¢ Content displays a set of tabs that will list modules by title, author, or 
keywords, and list the courses. 

¢ Software displays the "Connexions Technology" page that contains 
links to Connexions software and tools. 

¢ Help displays the "Help" page that contains links to installation, 
reference, and other information to answer your questions about 
Connexions. 


Breadcrumb Navigation Bar 


The "You are here" Breadcrumb navigation bar is located just below the 
"Home", "About", "Content", "Software", and "Help" tabs. This navigation 
tool is a breadcrumb trail of the Connexions pages you have displayed as 
you have drilled into Connexions to get to the current page. By clicking on 
any point within the breadcrumb trail you can return to that page. This 
feature is very useful for returning to the workgroup level page after 
working with the items within the workgroup. 


@ You are here: Home » Software » Connexions Markup Language » CNXML 0.5 


Breadcrumb navigation bar 


Search 


You can search the Content Commons for a specific module or a course 
using the Search button and text box in the upper right of the Connexions 
home page. Type in a name, keyword, course title, module title, text string, 
or object ID in the Search text box and click Search. Connexions will 


display a list of all modules and courses that match your entry. To view a 
module or course, click on its title. 


Quick Start Link 


Clicking on this link in the upper right of the Connexions home page 
displays the "Connexions Quick Start Guide" page. This page helps authors 
and instructors get started creating content with Connexions quickly. 


Courses Link 


This link in the upper right of the Connexions home page displays a list of 
the courses currently in the Connexions Content Commons. You can sort 
the display by course title, institution, or instructor to help you find a 
course. To open a course, click on the name of the course. 


Personal Toolbar 


The personal toolbar is located under the "Quick Start" and "Courses" links. 
The options on this toolbar vary, depending on whether you are logged into 
the system or not. 


If you are not logged into Connexions or you do not have a Connexions 
account, you can perform the following actions by clicking on the links in 
this toolbar: 


¢ Log into the system 
e Report a bug 
e Apply for a Connexions account 


You are notloggedin *Login *Reporta Bug *& Join 


Personal toolbar before login 


If you have a Connexions account and are logged into the system, you can 
perform the following actions by clicking on the links in this toolbar: 


e Display your personal workspace 

e Specify your personal preferences for your Connexions account, such 
as your title, your name, your e-mail address, your homepage URL, 
whether or not you want form help, and whether or not you want to 
display names. You can also reset your account password. 

e Report a bug 

¢ Log out of the system 


Ktechwriter = My Workspace My Preferences *Reporta Bug Log out 


Personal toolbar after login 


Navigation Sidebar 
This sidebar contains links to useful information about Connexions, similar 


to the information you can access through the "Home", "About", "Content", 
"Software", and "Help" tabs. 


Log in Sidebar 


If you have a Connexions account, you can log into the system in this 
sidebar. In addition, there is a link to reset your password (if you forgot it), 


and a link to the page for requesting a new Connexions account. This 
sidebar displays if you are not logged into the system. 
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Spotlight Sidebar 


This sidebar features a Connexions author who is being recognized for 
outstanding contributions to the Connexions Content Commons. A picture 
of the author appears along with a description of their work and links to 
their Connexions content. 


e-Mailbag Sidebar 


This sidebar displays examples of user comments submitted to Connexions. 
There is a link to additional user comments. 


What's New Sidebar 


This sidebar contains links to news items about the latest developments 
with Connexions. 


Workspaces Sidebar 


This sidebar contains links to your personal workspace, any workgroups of 
which you are a member, and the Create Workgroup page where you can 
create a workgroup. This item only displays if you are logged into the 
system. 
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Account Requests 
To apply for a Connexions account, use the following steps: 


1. Click on the New author or instructor? link in the "Log in" sidebar. 
The Request a Connexions Account page displays. 


Personal Details 


Title 


Enter your title e.g. Sir, Dr. 


First Name = 
Enter your first name, e.g. John 


[oo 


Middle Name 
Enter your middle name or initial, e.g. Q. 


Po 


Last Name = 
Enter your last name, e.g. Doe, 


Po 


Suffix 


Enter any name suffix, e.g. Jr. or III 


E-mail = 
Example: jdoe@example.com. See above for our policy, 


Po 


Homepage 
Enter the address of your personal webpage e.g. http://www.jdoe.com/~jdoe/ 


"Request a Connexions Account" page 


2. Type in your title, name, e-mail, and home page URL. The fields with 
red squares next to the field names are required. 

3. Click Continue. The "Account Request: Select Username" page 
displays. 

4. Type in a user name. A list of suggested usernames that are based on 
your entries in the First, Middle, and Last Name fields is shown. 


5. (Optional) Type in the fields of study for your contribution, indicate 
how you found out about Connexions, type in any comments you may 
have, and indicate if you would be willing to help test new features. 

6. Click Continue. The "Account Request: Confirmation" page 
displays. 

7. Review the site license agreement. 

8. Select the checkbox that says you have read and agree to the site 
license. 

9. Click Request Account. The "Account Request Complete" page 
displays. Connexions will send an e-mail to the address you entered in 
the step above. The e-mail contains directions for activating your new 
account. 


Logging In and Out 


To log into Connexions, enter your user name and password in the "Log in" 
sidebar and click Log in. 


Once you have logged in, the "Log in" sidebar is replaced by the 
Workspaces sidebar. The My Workspace and My Preferences links appear 
in the "Personal" toolbar. 


To log out, click the Log out link located in the Personal toolbar, in the 
upper right side of the Connexions home page. 


Overview of Authoring Modules 

This module gives an overview of the module creation process. This 
includes the text, files, and metadata of a module. Each step is described in 
further detail in other modules. 


What is a Module? 


A module is the basic building block of a Connexions course, textbook, or 
other type of collection. You can think of it as a small knowledge chunk that 
addresses a single topic or a specific aspect of a topic. Every author 
determines the size of their module, ranging from a few paragraphs to an 
entire textbook chapter. To a student or reader viewing a course or 
collection, a module is simply a web page in the collection. Modules allow 
readers to follow the information path arranged by the author or instructor 
or to branch off and discover their own path. To an instructor putting a 
collection together, having topics in different modules allows easy selection 
and arrangement of the information. An instructor can include existing 
modules from other courses or other academic disciplines that are important 
to the presentation of the course subject. 


Creating Modules 


You create and edit modules within one of your Work Areas. There are two 
ways to create modules: 


1. Create a new module from scratch. 
2. Create an adaptation of an existing module in the repository. 


Below are the steps to create a module from scratch. 
You can create a new module from the "Create New Item" dropdown in one 


of your work areas, or you can click the "Create a new module" link on the 
MyCNX home page: 


[missing resource: /content/m19610/latest/mycnx-create-and-edit- 


content.png |] 


Go the "MyCNX" tab and select the "Create a new module" link. 


From there you must agree to the license for this module, select a work area 
in which to edit the content, and then enter the module's initial metadata. 


After accepting the license, you will be asked to enter some basic 
information, or metadata, about your module before getting started. (If you 
haven't already selected a work area in which to work on the module, you 
will be asked to do so.) The basic metadata include: 


e Title (required) A title for the module 

e Language (required) The primary language used in the module 

e Subject(s) The subject categories that apply to the module 

e Keywords Terms that describe the most important topics in the 
module 

e Summary A brief description of the module. You may markup the 
summary section with inline CNXML tags. 


[missing resource: /content/m19610/latest/module-metadata.png | 


Enter basic information about your module here. 


Click the Save button. The metadata entries are saved and the "Contents" 
tab displays with the title of the collection. This tab is where you do the 
actual editing of the module content. 


Editing Modules 


Once you have opened a new or adapted module within one of your Work 
Areas, you will need to edit the module to add content and files (such as 


images). These operations are performed with the links and buttons on the 
"Manage Files" screen or the "Module Status" sidebar. The recommended 
sequence to perform these operations in is described in this module and 
appears in the following list: 


1. Edit the CNXML file. 

2. Add any other files that you want to associate with the module. 

3. Edit the metadata to enter the appropriate search keywords and the 
module title. 

. Edit the module roles. 

. Add links to the module. 

. Preview the module in both print and on-line versions. 

. Publish the module. 


NO U1 Bf 


Import Microsoft Word or OpenOffice documents 

How to enter content into Connexions by importing Word documents (*.doc 
extension). Documents may be edited in Microsoft Word, or an open source 
editor like OpenOffice Writer that allows you to save a document as *.doc. 


Overview 


One of the easiest paths for populating a module is the Word/OOo importer, 
which converts a *.doc document to CNXML. The importer overwrites any 
existing CNXML, so it is most useful as an initial import. We suggest using 
the online Edit-in-Place feature to make any further edits; any re-import of 
a Word or OpenOffice document will erase any other changes you have 
made using Edit-in-Place or the Full Source Editor. 


Who should use the Word/OOo importer? 

You should use the Word/OOo importer if you already have a Word or 
OpenOffice document saved that you wish to publish to the repository. The 
importer will correctly convert objects like section headings (designated by 
innate Word/OOo styles like Heading 1orHeading 2), paragraphs 
(separated by two line breaks), tables, lists, images, footnotes, and even 
mathematical objects. 


You can go one step further and apply the special CNXM.L styles in our 
template to your document so that you are able to import CNXML-specific 
objects like examples, problems, notes, citations, quotes, and more. The 
Word/OOo importer can produce most of the CNXML tags available for 
authors to use in their modules (see What can I import? below) and several 
combinations of tags. Any use case not available as a Word/OOo style must 
be added after import, either using the Edit-in-Place interface 
(recommended) or full-source editing. 

How does it work? 


1. First you need to apply the CNXML styles from our template to your 
document. We have sections below with specific instructions for both 
Word and OpenOffice. 

2. Next, you need to prepare your Word or OpenOffice document for 
import. The importer will ignore any user-defined styling, and requires 


specific markup in order to import other objects correct. We 
recommend that you read through the What can I import? section to 
learn what can be imported and make sure that your document has 
been properly prepared. 

3. Be sure to save with a *.doc extension (Windows 97-2003 
compatible). 

4. Create a new blank module in one of your Work Areas. 

5. Use the importer on either the Edit or Files tab to import your 
saved document. 


Preparing documents in Microsoft Word 
Download a copy of the document template (*.dot). 


You may also want to download a copy of a sample document (*.doc) that 
has been prepared to properly exercise all the features of the template. We 
encourage you to have a look at the document and practice uploading it (see 
"Uploading Your Document") to get a feel for how the Word import process 
works. 


Creating a new document with the template 


To create a new document in Microsoft Word to import into Connexions, 
download and open either the template or the sample document from above. 
In Microsoft Word go to the File menu and select Save As. In the "Save 
As" dialog box that appears make sure that "Word Document (*.doc)" or 
"Word 97-2003 (*.doc)" appears in the Save as Type drop-down box. 
Give your document a unique name in the File Name box, and click the 
Save button. You have now created a new Word document with the 
template styles included in it. Delete the default text from the template and 
begin typing your document, adding styles as you go as described below. 


Alternatively, you can install the template file into Word so that it is 
available through the New option in the Word File menu. Instructions to 


install this template are specific to your version of Word, so we recommend 
that you consult Word's Help feature if you wish to do so. 


Applying Styles to an Existing Document 


If you already have a document that you wish to import, you will need to 
apply the template styles to the document. To apply the template to an 
existing document, first open that document in Word. Then, follow the steps 
below: 


1. Go to the TOOLS menu and click Templates and Add-Ins. 

2. Click the Attach button, and use the file browser to navigate to the 
folder where you saved the template file. 

3. Select the "Connexions_Document.dot" icon in that folder and click 
Open. 

4. In the “Templates and Add-Ins” window, make sure the 
“Automatically Update document styles” box is checked and click Ok. 
(Eigure 1) 


[missing resource: ../content/m19610/latest/msword-applytemplate.jpg | 


Microsoft Word's template add-in window. 


As an alternative, you can also create a new blank document with the Word 
Importer template styles as described in "Creating a New Document with 
the Template". Once you have done so, you can copy and paste the text 
from your original document into the new blank document as follows. Go to 
the Edit menu in the original Word document and select the Select 

A11 option. Then go to the Edit menu in the original Word document 
again and select the Copy option. This copies the text of the original 
document to your system clipboard. Next, go to the Edit menu in the new 
blank Word document with the Word Importer template styles and select the 


Paste option. The text of the original document is now copied into your 
new document, and you can begin modifying it with Word Importer style 
information as described in the next section. 


Using styles in Microsoft Word 


If you are using Microsoft Word 97, you can find the style drop-down box 
on your format toolbar at the top of the screen (it usually displays the 
default style Heading 1 or Normal). In newer versions of Word the 
style menu is located under the "Home" tab. Click the pop-out icon in the 
lower right corner of the Styles menu to see a list of all styles. 


[missing resource: ../content/m19610/latest/wordStylesMenu.png | 


The Styles menu in new versions of Word. 


To apply a style to a specific piece of text, you follow the instructions 
below: 


1. Highlight the word, phrase, or paragraph you want to semantically 
mark up. 

2. Locate the styles menu. 

3. Click the name of the semantic style you want to apply to the 
highlighted text. The text that was highlighted is automatically given 
the style you selected. 


Preparing documents in OpenOffice Writer 


Download a copy of the document template (*.dot). 


You may also want to download a copy of a sample document (*.doc) that 
has been prepared to properly exercise all the features of the template. We 


encourage you to have a look at the document and practice uploading it (see 
"Uploading Your Document" below) to get a feel for how the Word import 
process works. 


Creating a New Document with the Template 


To create a new document in OpenOffice Writer to import into Connexions, 
download and open either the template or the sample document from above. 
In OpenOffice Writer go to the File menu and select Save As. In the 
"Save As" dialog box that appears make sure that "Word Document 
(*.doc)" or "Word 97-2003 (*.doc)" appears in the Save as Type drop- 
down box. Give your document a unique name in the File Name box, 
and click the Save button. You have now created a new document with the 
template styles included in it. Delete the default text from the template and 
begin typing your document, adding styles as you go as described below. 


Applying the Template to an Existing Document 


To apply the template to an existing document, create a new blank 
document with the OpenOffice Importer template styles as described in 
"Creating a New Document with the Template". Once you have done so, 
you can copy and paste the text from your original document into the new 
blank document as follows. Go to the Edit menu in the original 
OpenOffice Writer document and select the Select A141 option. Then go 
to the Edit menu in the original OpenOffice Writer document again and 
select the Copy option. This copies the text of the original document to 
your system clipboard. Next, go to the Edit menu in the new blank 
OpenOffice Writer document with the OpenOffice Importer template styles 
and select the Paste option. The text of the original document is now 
copied into your new document, and you can begin modifying it with 
OpenOffice Importer style information as described in the next section. 


Using styles in OpenOffice Writer 


You can see the styles available to you with the template by going to the 
Format menu and selecting the Styles and Formatting option. 
This brings up the "Styles and Formatting" box. Paragraph styles (such as 
Heading 1,Heading 2, and CNXML Quote) are available by clicking 
on the leftmost icon at the top of the box. Character styles (such as CNXML 
Emphasis, CNXML Code, and the rest of the application-specific styles) 
are available by clicking on the second-leftmost icon at the top of the box . 


Paragraph styles. Character styles. 
[missing_resource: [missing_resource: 
./content/m19610/latest/oowriter- _../content/m19610/latest/oowriter- 
paragraphstyles.jpg] characterstyles.jpg | 


To apply a style to a specific piece of text, you follow the instructions 
below: 


1. Select the appropriate style from the "Styles and Formatting" box. 

2. Make sure the "Fill Format Mode" tool is selected in the "Styles and 
Formatting" box (appears as the paint bucket icon in thefigure above. 

3. Highlight the text to which you wish to apply the style, and it will be 
applied. 


What can I import? 


e Other objects 
¢ Caution to users of MathType 5 
¢ Some common mistakes 


Text markup using the template styles 


We can use the text styles provided by the template to generate Connexions 
text markup tags when the document is imported. 


Emphasis 

The CNXML Emphasis style is used to give emphasis to important text. 
Use this style where you would have used bold or italics to emphasize 
particular words or phrases. Note that boldface and italicized text will both 
import as an emphasis tag with the appropriate effect attribute. 


Foreign 

The CNXML Foreign style allows us to designate a term which is in 
another language than the rest of the text. We can also point its usage at a 
website of our choice by marking it as a hyperlink in addition to CNXML 
Foreign. This will produce foreign text in a module. 


Code 

With the CNXML Code style, we can designate inline text as code written 
in a computer programming language. Use CNXML Code (Block) to 
designate blocks of code that should be set off from surrounding text. 


Cite 

The CNXML Cite style allows us to refer to non-electronic sources. If you 
are using Microsoft Word to prepare your document, you can cite a 
hyperlinked source by marking it as a hyperlink and then applying CNXML 
Cite. This is produce a citation in Connexions. 


Term 

With the CNXML Term style, we can designate key terms in our document. 
If you are using Microsoft Word to prepare your document, you can also 
point this term at an example of its usage by marking it as a hyperlink and 
then applying CNXML Term. 


Quote 
Using the CNXML Quote (Block) style, we can designate a section of 
text as a block quote from another source. Use CNXML Quote 


(Inline ) to designate inline quotes that should not be set apart from the 
surrounding text. If you are using Microsoft Word to prepare your 
document, you could also point this at an online source by marking it as a 
hyperlink and then applying CNXML Quote (Inline). 


Hyperlinks 

Using the HyperLink style, we can create a hyperlink pointing to a URL. 
This will become a link element in your Connexions module. We can also 
point at specific locations within the document by pointing, for example, at 
any section title created using the H1, H2, ... styles, or at any bookmark we 
have inserted into the document. 


Exercise 

We can make exercises that only have problems by marking them up using 
the CNXML Exercise (Problem) style. We can also make exercises 
that have problems and solutions by following the text marked CNXML 
Exercise (Problem) with some more text marked CNXML 
Exercise (Solution). 


Theorems 

We can have theorems with or without proofs. To make a theorem 
statement, we can use the CNXML Theorem (Statement ) style. To 
construct a theorem with both a statement and a proof, we use CNXML 
Theorem (Statement) followed by CNXML Theorem (Proof). 


Definitions 

We can have terms with definitions. To do so, we mark the term using the 
CNXML Definition (Term) style, and we follow it with the 
explanation marked using the CNXML Definition (Meaning) style. 


Notes 
We can create note boxes using the CNXML Note style. 


Examples 
We can create example boxes using the CNXML Example style. 


Other objects 


We can do more than just mark up text using the Word/OOo importer. We 
can also add images to our document, create tables, add lists, and even 
insert mathematical expressions... 


Sections 

H1 applied to a section title produces a new section. The section lasts until 
the next H1-marked title. An H2-marked title in between produces a 
subsection (which lasts until the next H2- or H1-marked title). 


Paragraphs 

You can also use certain features of the Word or OpenOffice editor to 
produce other CNXML tags. Pressing Enter gives a new line and 
produces a new paragraph. 


Images 

You can insert images into your Word document as you would normally, 
and they will import into Connexions. It’s best to stick to image types such 
as with .eps, .jpg, .png, and .gif (or any format with a valid image type); 
avoid formats such as .wmf and .svg, and avoid Clip Art. 


Use only images that are locally available on your machine. Make sure 
either that (1) the images are already available under a creative commons 
(CC) attribution license, or (2) you own the image copyrights and are 
willing to make them available under a CC attribution license. 


Figure 

We can precede images with text marked with the CNXML Figure 
Title style to give them a title, and follow them with text marked in the 
CNXML Figure Caption style to give them a caption. This will 
produce a figure in the module. 


Tables 
Using the built-in Word table editor, we can create tables which are easily 
imported into Connexions. 


Lists 


We can create both bulleted and numbered lists using Word or OpenOffice 
and bring them into Connexions using the importer. 


Mathematics 
We can include mathematics in a line of text. Mathematics set off from 
other text in its own paragraph will import as an equation. 


In OpenOffice, choose Insert > Object from the menu and then 
select Formula. 


In Word we can use the built-in Equation Editor 3.0. To do this, choose 
Insert > Object from the menu and select Equation Editor 3.0. 
Note:It is very important that you insert and equation through the Object 
menu. Newer versions of Microsoft Word have an option to insert an 
Equation, located under the Symbols menu. Do not use this as it will not 
import correctly. 


[missing_resource: ../content/m19610/latest/wordEquationObject.png] 


Insert equations through the Object menu. 


If you can’t find the Equation Editor 3.0 option in the list, you must install 
Equation 3.0 from your Microsoft Office installation CD. Please consult 
your Microsoft Office help for more information on this procedure. 


Note:If you have MathType 5 installed on your system, math will not 
import correctly. See below for how to remedy this. 


[missing_resource: http://cnx.org/content/m19610/latest/msword- 
insertegedobject.jpg] 


Microsoft Office object insert window. 


Footnotes 
Footnotes inserted using the native footnote tool will import as Connexions 
footnotes. 


Glossary 

Finally, we can designate a glossary section for our module. We must first 
give it a title and mark that with the CNXML Glossary Section style. 
This must be the last section designation used at the end of your word 
document, and it cannot be followed by H1, H2, etc. styles. Then, for each 
glossary element we wish to include, we mark the term portion with CNXML 
Definition (Term) and the meaning portion with CNXML 
Definition (Meaning), as we did before in the body of our 
document. 


Caution to users of MathType 5 


MathType 5 is a stand-alone equation editing package written by Design 
Science, makers of the Microsoft Equation 3.0 editor. When MathType 5 is 
installed on your system, equations written with the Microsoft equation 
editor will be saved as MathType 5 equations rather than Equation 3.0 
equations. Even merely editing equations from a document with Equation 
3.0 equations on a machine with MathType 5 will cause those equations to 
be saved in MathType 5 format. This is problematic, since the Word 
importer cannot properly convert MathType 5 equations to Presentation 
MathML. 


We recommend un-installing MathType 5 from your system if it is currently 
installed. This will cause Word to revert to using Equation 3.0 for equation 
editing, which will allow the Word importer to properly generate 
mathematics. 


Should you inadvertently include a MathType 5 equation in your Word 
document, in the Edit-in-Place interface where the mathematics should 
appear you will instead see the warning message shown in Figure 5. 


[missing_resource: http://cnx.org/content/m19610/latest/eip-display-para- 
unsupportedmedia.jpg | 


Edit-in-Place warning for MathType mathematics import. 


You can go replace each of these warning messages by hand using the 
following procedure. To begin, double click on the MathType equation in 
Word to open the MathType editor. 


If this is your first time to use this procedure, you must configure MathType 
to properly generate MathML. Go to the Preferences menu and select 
the Translators option. In the window that appears, make sure that 
“Translation to other language (text)” is selected, and in the drop-down box 
next to “Translator:”, select the “MathML 2.0 (m namespace)” option. Also, 
make sure that “Include translator name in translation” and “Include 
MathType data in translation” are NOT selected (see Figure 6 below). Click 
OK to complete the configuration. This sets the translation preferences 
permanently, so you will not have to repeat these steps again. 


[missing resource: http://cnx.org/content/m19610/latest/mathtype- 
settranslators.jpg | 


Setting the translator in MathType to copy MathML to the system 
clipboard. 


Once the Translators preferences are set, you can copy the MathType 
equation’s MathML equivalent by highlighting the equation in the 
MathType editor and copying to the clipboard (Edit menu, Copy option). 
This stores a copy of the MathML on your system’s clipboard. 


Return to your browser and find the appropriate placeholder for the 
equation in the Edit-in-Place interface (appearing as in Figure 5). Double 
click to edit the paragraph and delete the text “***SORRY, THIS MEDIA 
TYPE IS NOT SUPPORTED***” (Figure Figure 7 below). Paste the 
contents of the clipboard into is place (Figure Figure 8), and click Save. 
Your equation should now appear in the Edit-in-Place interface (Figure 
Figure 9). 


[missing resource: http://cnx.org/content/m19610/latest/eip-edit-para- 
unsupportedmedia.jpg | 


Editing the paragraph with the warning text 


[missing resource: http://cnx.org/content/m19610/latest/eip-edit-para- 
pastemml.jpg] 


Pasting the MathML copied from the MathType editor into the 
paragraph where the equation should appear. 


[missing_resource: http://cnx.org/content/m19610/latest/eip-display-para- 
mml.jpg] 


MathML equation appearing in the edit-in-place interface. 


Some common mistakes 


It is important that you follow the instructions on this page for each object. 
Do not use other objects or text, including: 


I 


Do not add line breaks betwen paragraphs using cnt1-Enter. This 
will not import as a new paragraph. 


. Do not use tabs. This formatting will not import. 
. Do not use lists or tables to invisibly format the document, as these 


constructs are literally imported as lists and tables into CNXML. 


. Do not continue list numbering across separate lists. 
. Do not insert images whose source files are remotely available via a 


hyperlink. 


. Do not use Word’s image captioning option; the caption will import as 


a new paragraph. 


. Do not use fonts such as “Wingdings" to produce symbols: They will 


be interpretted as text. 


. Do not use the MathType editor inside Word to create equations. This 


is the default (and only) option if MathType is installed on your 
system. See the Notes on Including Mathematics section for more 
details. 


Uploading your document 


I, 
2 


If you have not already done so, create a new blank module. 
Use the help documents linked above to ensure you have prepared 
your document correctly; otherwise you may get an error. 


3. The importer dropdown menu is accessible on both the module 


Content tab and the Files tab when editing the module. Choose 
the importer type from the dropdown menu and click Import 


[missing resource: http://cnx.org/content/m19610/latest/import-menu- 
expanded.png] 


The module import menu (expanded). 


4. On the next page, browse to your saved file on your harddrive and 
click Import. 


[missing resource: http://cnx.org/content/m19610/latest/edittext-import- 
browse-empty.jpg]| 


Browse to file. 


How to Use the Collection Composer 
Instructions on how to use the Connexions Collection Composer (formerly 
known as the Course Composer). 


The Connexions Collection Composer 


The Collection Composer (formerly known as the Course Composer) 
allows you to create new collections or edit existing collections. Any 
number of modules within Connexions' Content Repository can be used to 
create a collection. You can perform the following tasks with the Collection 
Composer: 


e Add and arrange elements 


Add a module 

Add a new subcollection (section) 

Rearrange contents 

Remove contents 

Advanced editing of the collection's elements 


o Oo 0 0 90 


= Provide an alternate module title 
= Select the module version 
= Edit or add links on a module 


e Edit an existing collection 


Adding and Arranging Elements 


At this point, you should have landed on the "Contents" tab of the collection 
composer. This is where you will add and arrange the contents of your 
collection. Basic instructions are provided at the top, but we will go through 
each editing feature in detail. 


[missing resource: http://cnx.org/content/m19610/latest/content-empty.png | 


A collection in the making, before any content has been added. 


At first, all that is shown is the collection's title (in this case "Tutorial") and 
the three actions you can take at the collection's top level: 


e Add subcollections 
e Add modules 
e Fdit title 


Let's start by adding the introductory module to the collection structure. 


Add a Module 


You can add already published modules to the collection from the Content 
Repository. You cannot add unpublished modules from your workspaces. 
When adding a module, Connexions does not copy the module into your 
collection. The module remains in the Content Repository and 
Connexions inserts a reference or a pointer to the module in your 
collection. A module cannot be inserted into a collection more than once. 


Instructions for adding a module 


In our example, we first want to add a module entitled Connexions 
Workshop: Introduction to the top of the collection. To do this, we start by 
hovering the mouse over the collection's title. To the right, there is a link 
reading "Add modules”: 


[missing resource: http://cnx.org/content/m19610/latest/add-module-to- 
collection.png] 


Hover over the collection title to see the option to "Add modules" to 
the collection. 


Click the "Add modules" link. A pop-up appears with a search box. Enter a 
word, name, or text string related to the module in the search text box. Click 
the "Search for modules" button: 


[missing_resource: http://cnx.org/content/m19610/latest/add-module- 
popup.png]| 


A pop-up appears in which you can use to search for modules to add. 


Results will appear in the same pop-up. If you don't find the module you 
were searching for on first attempt, you can try using a different search 
term, sorting the results by another parameter, adjusting the number of 
searches that display per page, or going to the next page of results. Once 
you find the module or modules you want to add, select the checkbox next 
to its title(s) and click "Add selected content". 


[missing resource: http://cnx.org/content/m19610/latest/add-module- 
popup-selected.png] 


Select the checkbox of each module you want to add to the collection. 


The module you've selected to add to the collection will now appear below 
the collection's title in the composer. Remember that this only a pointer to 
the published module, not a copy of the module itself. 


[missing resource: http://cnx.org/content/m19610/latest/add-subcollection- 


to-collection.png | 


The added module appears in the composer. 


Let's now continue on to the next step of adding our two subcollections. 


Add a New Subcollection (Section) 


A subcollection is a grouping of related modules within a collection. 
Depending on the nature of your collection, you might think of a 
subcollection as a section, chapter, part, folder, division, etc. Each 
subcollection has a heading that identifies its contents to the viewers. You 
may place subcollections within other subcollections, as deeply nested as 
desired. 


Instructions for adding a subcollection 


In our example, our collection is structured by two "Parts" that follow the 
introductory module. To add these, we start by hovering the mouse over the 
collection's title. To the right, there is a link reading "Add subcollections": 


[missing resource: http://cnx.org/content/m19610/latest/add-subcollection- 
to-collection.png | 


Hover over the collection title to see the option to "Add 
subcollections" to the collection. 


Click the "Add subcollections" link. A pop-up appears with a text box. 
Enter the titles of the subcollections you want in your collection, one per 
line. Click the "Add new subcollections" button: 


[missing_resource: http://cnx.org/content/m19610/latest/add- 
subcollections-written.png] 


A pop-up appears in which you can add the titles of your collection's 
subcollections. 


Your subcollections will now appear in the composer below any other 
modules or subcollections you've already added at that level. From there, 
you can hover your mouse over each subcollection and find a list of actions 
to take at the subcollection level, such as adding modules, adding nested 
subcollections, or editing the subcollection's title. 


[missing_resource: http://cnx.org/content/m19610/latest/add-module-to- 
subcollection.png] 


Your subcollections are now in the composer and modules can be 
added inside them. 


Let's add some more modules to each of these subcollections so that your 
collection structure now looks like this: 


[missing_resource: http://cnx.org/content/m19610/latest/content-filled.png] 


Modules added to the subcollections. 


Before things are done, we have some changes we want to make. Let's 
continue. 


Rearrange Contents 


Since the collection composer adds modules and subcollections to the 
bottom of the collection or subcollection where you added them, you will 
sometimes need to rearrange the modules and subcollections to get them in 
the desired ordered. To do this, simply click down on the title of the item 
you want to move, drag it over to the desired location, and click up to drop 
it in that location. A dotted line appears where there is a valid location to 
drop the item. 


[missing resource: http://cnx.org/content/m19610/latest/rearrange-1.png | 


Click down on the title of a module or subcollection to move it. 


[missing resource: http://cnx.org/content/m19610/latest/rearrange-2.png | 


Drag the module or subcollection over to its new location. A dotted 
line appears where there is a valid location to drop the item. 


Note: Rearrangements don't have to be strictly vertical movements of 
modules, as shown in the example. You can move both modules and 
subcollections, and you can move them up, down, into subcollections, or 
out of subcollections. 


The new structure is automatically saved when the item is dropped in place. 


Collapsing/expanding subcollections for easier editing 


If your collection contains a lot of modules and subcollections, it can 
become cumbersome to edit (especially for dragging and dropping). If this 
is the case in your collection, you can collapse the subcollection by clicking 
on the arrow to the left of the subcollection title. 


[missing_resource: http://cnx.org/content/m19610/latest/collapse- 
subcollection.png] 


Click the arrow icon next to a subcollection's title to toggle it open or 
closed. 


Subcollections without any titles do not have the expand/collapse toggles 
next to their title. 


Note:When first checking out a collection, or when returning to the 
collection composer after having gone elsewhere, all subcollections appear 
closed by default. To see and/or edit their contents again, simply click the 
arrow toggle next to each collection title. 


Remove Contents from the Collection 


To remove a module or subcollection from the collection, hover your mouse 
over the item. At the right, there will be a link reading "Remove from 
collection". In the example, let's say you've decided not to include the 
module titled Module from Word Document: 


[missing_resource: http://cnx.org/content/m19610/latest/remove- 
module.png] 


A pop-up appears confirming that you want to remove the module. Behind 
the pop-up, the module marked for deletion is highlighted in pink with its 
title crossed out: 


[missing_resource: http://cnx.org/content/m19610/latest/remove-module- 
popup.png] 


Confirming removal of a module. 


[missing_resource: http://cnx.org/content/m19610/latest/remove- 
subcollection-popup.png] 


Example showing the removal of an entire subcollection. Note that the 
you are shown an extra warning about any modules or subcollections 
inside the subcollection you are about to remove. 


Note: Removing modules from a collection does not remove them from 
the Content Repository. It only removes the pointer in your collection to 
that published module. 


Advanced Editing of the Collection's Elements 


Provide an Alternate Module Title 


Modules that are published in the Content Repository display the titles 
given to them by their authors. If these titles are not appropriate for the 
module when it appears in the context of your collection (e.g., it may 
contain numbering), you can provide an alternate title for the module. The 
module displays your alternate title when it is accessed from within your 


collection. The module displays its original title whenever it is accessed 
from outside of your collection. 


In our example, let's rename "Creating a Module in Minutes" to "Creating a 
Connexions Module" in order to match the similarly titled module in Part II 
of the collection. Hover over the module's title and click on the "Edit 
title/version" link that appears to the right: 


[missing resource: http://cnx.org/content/m19610/latest/edit-title- 
version.png | 


A pop-up appears. In the text field under "Alternate Title", type the title 
with which you want to override the module's title. Click "Save". 


[missing_resource: http://cnx.org/content/m19610/latest/edit-title- 
popup.png| 


If you want to undo the override, simply return to the pop-up, erase the text 
from the "Alternate Title" text field, and click "Save" again. The module's 
title will revert to its original one. 


Select the Module Version 


When a module is updated or edited, Connexions saves the previous version 
of the module in history and uses the latest version of the module for 
viewing. Each new version of a module is given its own version number. 
You can either have your collection always use the latest version of the 
module, or you can pinpoint a specific version to be used. 


In the example, let's say that version 1.2 of one of the modules we include 
was a complete reformatting of that module's content, and that the new 
format no longer makes sense in the context of your collection. Hover over 


the module's title and click on the "Edit title/version" link that appears to 
the right: 


[missing resource: http://cnx.org/content/m19610/latest/edit-title- 
version.png | 


A pop-up appears. In the "Set Version" area, select version 1.1 from the 
dropdown. Click "Save". 


[missing_resource: http://cnx.org/content/m19610/latest/edit-version- 
popup.png] 


Edit or Add Links on a Module 


Links allow the viewer to display related information or examples that are 
not part of the collection with the click of a mouse. Links may be defined 
by the module's author, but they may also be added or 
redefined/overridden/removed for that module by the collection's author. 
Any changes you make in the collection composer to a module's links only 
display when viewing the module from within your collection. 


In the example, let's say that you felt strongly that the introductory module 
really needed a link to the Connexions home page. To add this link, hover 
your mouse over the module's title. Click the link at right reading "Edit 
featured links": 


[missing resource: http://cnx.org/content/m19610/latest/edit-links.png] 


A pop-up appears, and it includes a form where we can enter the new link's 
information. (If this module's author had already included links in the 
module, the form would have been hidden behind a link reading "Create a 


new link".) Enter some text for the link, select which type of link it is, the 
link's strength (how strongly related the link is to the content) and either a 
URL or the ID of another collection. 


[missing_resource: http://cnx.org/content/m19610/latest/edit-links- 
popup.png] 


Click "Add New Link". The link will then be added to a table. From there, 
you can edit the link, remove it, or add another one. When you are finished, 
click the "Done" button. 


[missing _resource: http://cnx.org/content/m19610/latest/edit-links-popup- 
existing.png | 


Now the links will be present on the module when viewed from inside your 
collection. 


Edit an Existing Collection 


You can edit an existing collection with the Collection Composer in the 
same Way you Create a new collection. You can edit only collections for 
which you have a maintainer role. To use the Collection Composer on an 
existing collection, first make sure you are logged in, then you can: 


e Either derive a copy of a collection (if you wish to make an adaptation 
of the original collection), 

e Or checkout a collection (yours or someone else's) into one of your 
work area. 


Setting Up a Workgroup 


How to create a workgroup and use it as a workspace for your Connexions 
documents. 


Note: This module has been retired as it contained Connexions 
documentation which is no longer accurate and/or relevant. The current 
documentation of topics in this module can be located at 
http://cnx.org/content/m37462/latest/. Please visit the help page for up-to- 
date information about the Connexions website, including support for 
viewing and authoring content and the CNXML language. If you have any 
additional questions or cannot find the answer to your question, please 
contact techsupport@cnx.org and we will be happy to assist in any way we 
can. 


Reference 


e Connexions Tutorial and Reference 
¢ Connexions Workshop in Vietnam DVD #1 DVD #2 
e Vietnam OpenCourseWare Project 


